Neste artigo, você aprenderá sobre uma nova maneira de passar dados de um formulário para uma URL remota - Webhook. Usando um webhook, você pode trocar informações com recursos de terceiros. Por exemplo, faça uma chamada para seu URL individual ou envie dados de formulário para esse endereço.

Webhooks permitem integrar fluxos de trabalho entre sistemas/serviços/aplicativos (incluindo chamadas entre diferentes projetos dentro de um sistema QuintaDB). Isso é uma grande ajuda para organizar seus processos de negócios, e temos certeza de que você encontrará muitas maneiras de aproveitar os webhooks.

Contente:

• Aplicando Webhooks por meio do campo "Ação"
  • Criar uma tarefa
  • Configurações do webhook
  • Request headers
  • Parâmetros de solicitação
• Aplicando Webhooks por meio de "Ações Condicionais".

Observação: os webhooks destinam-se principalmente à comunicação com serviços externos. Dentro do sistema QuintaDB, basta utilizar ferramentas padrão como Relacionamento e Subformulário.

Você pode usar o Webhook com:

- Campo de Ação;

- Módulo de Ações condicionais.

Vamos ver como isso funciona. Como exemplo, usaremos o aplicativo Agência de conteúdo, que pode ser instalado na página do aplicativo.

Além disso, usaremos o serviço webhook.site para a demonstração. Isso pode ser qualquer URL que você quiser.

Copie seu URL exclusivo. Agora vamos abrir o formulário Artigos em nosso aplicativo Agência de conteúdo.

Considere a primeira maneira - o campo de Ação:

1. Adicione o campo "Ação" ao formulário (você pode encontrá-lo na guia "Adicionais");

2. Abra a página de edição de campo. Acesse a aba "Tarefas" ou selecione o item "O que fazer";

3. Crie uma nova tarefa. Selecione o tipo de tarefa do Webhook;

4. Vá para a seção "Configurações".

 Aqui você precisa inserir o URL (neste exemplo, este será o URL recebido no serviço webhook.site ).

Selecione os data transfer method (GET, POST, PATCH, DELETE). Para obter mais informações sobre métodos de transferência de dados, leia a documentação da API.

Selecione os Content-Type (multipart/form-data, application/x-www-form-urlencoded, application/json).

Neste exemplo, usamos o POST  método e o application/json modelo.

5. Na seção "Request headers", você pode adicionar um cabeçalho e dados para autorização (opcional);

6. Na seção "Solicitar parâmetros", você precisa especificar o nome do parâmetro e selecionar os campos do formulário:

Além disso, você pode escolher Personalizado na lista. Assim, você passará um parâmetro individual, em vez de um valor do formulário.

Atenção: Para passar o dono do record atual, você precisa adicionar um parâmetro personalizado "copy_owners" com qualquer valor por exemplo "1", na seção "Solicitar parâmetros":

7. Clique no botão "Criar".

8. Clique em "Ação" na tabela para teste:

9. Verifique o resultado da transferência de dados no serviço Webhook:

Todos os dados foram transferidos com sucesso.

Agora vamos ver outro método pelo módulo de Ações condicionais.

Usaremos o mesmo formulário.

1. Vá para o Construtor de formulários e abra a guia Ações. Crie uma nova ação condicional.

2. Selecione um critério para realizar a ação (por exemplo, o campo Título não está vazio).

• Especifique o nome e quando realizar a ação (Formulário enviado, Registro atualizado, Pagamento concluído ou tudo ao mesmo tempo).
• Selecione a ação do webhook.

Observe: neste caso, não há transição para outra página, e todos os dados são armazenados em paralelo em seu banco de dados QuintaDB.

3. Clique no botão "Editar" após criar a ação:

4. Você precisa configurar o webhook da mesma forma que as configurações no campo Ação. Clique no botão "Editar" ao lado da ação "Webhook".

Observação: você usará uma chamada de API dos recursos da sua conta toda vez que transferir dados.